home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / filutil / uudvd_04.zip / README < prev    next >
Text File  |  1995-02-04  |  6KB  |  144 lines
  1. UUdeview Readme
  2. ***************
  3.  
  4. The Problem
  5. ===========
  6.  
  7. You can't post (or email) binary files to newsgroups as binary files, since
  8. binary files contain lots of unprintable characters. Therefore, files must be
  9. coded into printable characters. There are a couple of methods available,
  10. like the macintosh binhex. The most popular encoding method is
  11. uuencoding, which first became standard in the unix world.
  12.  
  13. Unfortunately, there is another limitation to mailing or news-posting coded
  14. programs, since many mail or news gateways have an upper file size limit.
  15. Therefore, files must also be split into multiple parts to allow these
  16. gateways to handle them.
  17.  
  18. But the standard decoder programs aren't built to handle this. They can
  19. only work unsplit files. Concatenating the individual mails/postings does not
  20. help, since they contain lots of headers that confuse the decoder. The only
  21. help is to manually delete the headers from the mails/postings with a text
  22. editor. And, some of the bigger files come in more than 50 parts. You don't
  23. want to sit down and edit 50 files only to see a single animation, do you?
  24.  
  25. And still we're not through yet. Although the files are usually posted in the
  26. right order, they don't necessarily arrive correctly ordered. So you must
  27. also manually put them in order.
  28.  
  29. I hope I have you convinced by now that you do not want to have to do this
  30. stuff. By now, you should think "Well, there must be something to simplify
  31. decoding". And you're right. This is where UUdeview steps in. 
  32.  
  33. The Idea
  34. ========
  35.  
  36. The Idea was to create a program that does all the work for you. You
  37. should not have to manually strip headers, and you shouldn't be troubled
  38. by the order of the files. And, the program should be able to process
  39. multiple files at once.
  40.  
  41. Now combine all this with a simple and friendly user-interface, and you
  42. have UUdeview! 
  43.  
  44. Featuring ...
  45. =============
  46.  
  47. Some of the highlights include: 
  48.  
  49.  o Shoot'em'up interface. You fire up the program will all input files on
  50.    the command line, and uudeview will then present you all
  51.    decodeable files. 
  52.  o Basically is a smart multi-file multi-part decoder, but also feels at
  53.    home dumbly with single-file single-part input. 
  54.  o Features the encoding schemes "UUencode", "XXencode" and
  55.    "Base64" (aka MIME); these schemes are auto-detected for
  56.    each email/article. 
  57.  o Ports exist for Unix, DOS and Windows, so if you frequently change
  58.    your operating system, UUdeview will migrate with you. 
  59.  o The unique SPMS(r) technology sometimes allows to recover from
  60.    errors in the original postings' subject line. If you have parts 1,2 and
  61.    4 of 'test' and part 3 of 'toast', the program will try to guess these
  62.    parts belong together. 
  63.  o The Unix and DOS versions allow file previews without decoding
  64.    the file (well, in fact it is decoded, but you won't notice) 
  65.  o Usually asks before decoding each file, but can as well be
  66.    configured for batch-decoding. 
  67.  o The Windows version includes the UUdeview Launcher, allowing
  68.    for drag-and-drop decoding, and selection of options by
  69.    mouseclick 
  70.  
  71. The Philosophy
  72. ==============
  73.  
  74. UUdeview's philosophy is "to work". Thus it is programmed for to be smart
  75. and will decode files that other programs don't, or decode incorrectly. On
  76. the other hand, it is not designed for maximum fanciness; compared to
  77. other decoders it may look anachronistic. But you can decide on your own
  78. whether you want maximum operatability or maximum fanciness. And
  79. then there is another feature in favour of UUdeview, distinguishing it from
  80. other, similar utilities: It is free. I have found that most other decoders fit into
  81. one of two categories. Either they are not too bright (most get confused by
  82. parts that are not ordered), or they are not free. 
  83.  
  84. Behind the Frontend
  85. ===================
  86.  
  87. UUdeview evaluates the 'subject:' line. From the subject line, it tries to
  88. derive the name of the file and the part number. It looks for a filename of the
  89. kind string.suffix (also accepting more than one suffix). This file name must
  90. then appear on all subject lines containing other parts from this file (if it
  91. doesn't, hope for SPMS). If there's nothing on the subject that looks like a
  92. file name, don't worry, then UUdeview will find something else. And this
  93. subject-line file name isn't used for anything else than subject-line
  94. matching, anyway. For the actual file, the filename from the 'begin' line is
  95. used.
  96.  
  97. The program is also quite tolerant with part numbers. First, it looks for
  98. numbers in brackets (16/22) or (16 of 22) or simply (16). Secondly, it looks
  99. for the same kind of information in square brackets. Then it looks for the
  100. string "Part 16" or "Part #16" or something similar. As long as there
  101. actually is a part number, chances are that it will be found. 
  102.  
  103. Will there ever be a version 1.0?
  104. =================================
  105.  
  106. UUdeview was originally developed for Unix only, and it was planned to
  107. feature a full-screen curses menu-driven interface. Then I thought about
  108. it some more, discovered the above philosophy and found it not necessary
  109. for a program such simple to have a bombastic interface -- which would
  110. only make it more incompatible. Because this interface was planned for
  111. 1.0, and I have now decided not to include such an interface, it is unlikely
  112. that there will ever be version 1.0. But hey, the version is only a number that
  113. really doesn't tell anything. 
  114.  
  115. Known Bugs
  116. ==========
  117.  
  118.  o UUdeview only accepts Base64 (MIME) data that has a line length
  119.    of a multiple of four. The MIME standard does not enforce a
  120.    particular length. So far, no file with a non-multiple-of-four line
  121.    length has been found. 
  122.  o In its desperate attempts to merge file parts, SPMS might
  123.    infrequently produce a junk file (consisting partially of an AU file
  124.    and partially of an MPEG, for example). Again, this has yet to
  125.    happen to me. 
  126.  
  127. Famous last words
  128. =================
  129.  
  130. Although the program is free, donations are always gladly accepted
  131. <grin>, be it postcards, email, hardware or anything else. I will conquer the
  132. last step in the evolution of UUdeview, the Macintosh port, as soon as
  133. someone donates me a Mac. 
  134.  
  135. For you lawyers out there:
  136. Unix is a registered trademark of AT&T.
  137. Windows is a registered trademark of Microsoft.
  138. Macintosh is a registered trademark of Apple.
  139. UUdeview and SPMS are unregistered trademarks of Frank Pilhofer
  140. Projects (FPP)
  141.  
  142. Frank Pilhofer <fp@informatik.uni-frankfurt.de> Back to the Homepage
  143. Last modified: Fri Feb 3 09:30:21 1995 
  144.